<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>set_cache_max</title>
    <link rel="stylesheet" href="apiReference.css" type="text/css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
    <link rel="start" href="index.html" title="Berkeley DB C API Reference" />
    <link rel="up" href="configuration_reference.html" title="Appendix D. DB_CONFIG Parameter Reference" />
    <link rel="prev" href="set_cachesize_parameter.html" title="set_cachesize" />
    <link rel="next" href="set_create_dir_parameter.html" title="set_create_dir" />
  </head>
  <body>
    <div xmlns="" class="navheader">
      <div class="libver">
        <p>Library Version 12.1.6.2</p>
      </div>
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">set_cache_max</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="set_cachesize_parameter.html">Prev</a> </td>
          <th width="60%" align="center">Appendix D. DB_CONFIG Parameter Reference</th>
          <td width="20%" align="right"> <a accesskey="n" href="set_create_dir_parameter.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <div class="titlepage">
        <div>
          <div>
            <h2 class="title" style="clear: both"><a id="set_cache_max_parameter"></a>set_cache_max</h2>
          </div>
        </div>
      </div>
      <p>
                  Sets the maximum size that the <code class="literal">set_cachesize</code>
                  parameter is allowed to set. The specified size is rounded to the
                  nearest multiple of the cache region size, which is the
                  initial cache size divided by the number of regions specified
                  to the <code class="literal">set_cachesize</code> parameter.  If no value
                  is specified, it defaults to the initial cache size.
             </p>
      <p>
                 The syntax of this parameter in the <a href="../../programmer_reference/env_db_config.html#env_db_config.DB_CONFIG" class="olink">DB_CONFIG</a> file is a
                 single line with the string
                 <code class="literal">set_cache_max</code>, one or more whitespace
                 characters, and the maximum cache size in bytes, specified
                 in two parts: the gigabytes of cache and the additional
                 bytes of cache.  For example:
             </p>
      <pre class="programlisting">set_cache_max 2 524288000</pre>
      <p>
                 Sets the maximum cache size to 2.5GB.
            </p>
      <p>
                This parameter can be changed with a simple restart of your
                application; you do not need to re-create your environment for it
                to be changed.
            </p>
      <p> For more information, see <a class="xref" href="envset_cache_max.html" title="DB_ENV-&gt;set_cache_max()">DB_ENV-&gt;set_cache_max()</a>.</p>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="set_cachesize_parameter.html">Prev</a> </td>
          <td width="20%" align="center">
            <a accesskey="u" href="configuration_reference.html">Up</a>
          </td>
          <td width="40%" align="right"> <a accesskey="n" href="set_create_dir_parameter.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">set_cachesize </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> set_create_dir</td>
        </tr>
      </table>
    </div>
  </body>
</html>
